---
displayed_sidebar: "Chinese"
---

# to_tera_timestamp

## 功能

将某一个 VARCHAR 类型的值按指定的格式转换成 DATETIME 类型的值。

## 语法

```Haskell
DATETIME to_tera_timestamp(VARCHAR str, VARCHAR format)
```

## 参数说明

- `str`：待计算转换的时间表达式，取值必须是 VARCHAR 数据类型。

- `format`：计算转换后生成的 DATETIME 值的返回格式。

  有关返回格式中各元素的含义介绍，参见下表。

  | **Element**           | **Description**                                              |
  | --------------------- | ------------------------------------------------------------ |
  | [ \r \n \t - / , . ;] | 标点类符号，忽略。                                           |
  | dd                    | 代表一个月中的第几天。取值范围：`1` - `12`。                 |
  | hh                    | 代表一天中的第几个小时，采用十二小时制。取值范围：`1` - `12`。 |
  | hh24                  | 代表一天中的第几个小时，采用二十四小时制。取值范围：`0` - `23`。 |
  | mi                    | 代表分钟。取值范围：`0` - `59`。                             |
  | mm                    | 代表月份。取值范围：`01` - `12`。                            |
  | ss                    | 代表秒。取值范围：`0` - `59`。                               |
  | yyyy                  | 代表四位数的年份。                                           |
  | yy                    | 代表两位数的年份。                                           |
  | am                    | 代表十二小时制里的上午。                                     |
  | pm                    | 代表十二小时制里的下午。                                     |

## 示例

将 VARCHAR 类型的值 `1988/04/08 2:3:4` 按 `yyyy/mm/dd hh24:mi:ss` 格式转换成 DATETIME 类型的值：

```SQL
MySQL > select to_tera_timestamp("1988/04/08 2:3:4","yyyy/mm/dd hh24:mi:ss");
+-----------------------------------------------------------+
| to_tera_timestamp('1988/04/08 2:3:4', 'yyyy/mm/dd hh24:mi:ss') |
+-----------------------------------------------------------+
| 1988-04-08 02:03:04                                       |
+-----------------------------------------------------------+
```

## 关键字

TO_TERA_TIMESTAMP
